/**
 * Copyright (c) 2012, Brent Mucci
 * All rights reserved.
 * 
  * Redistribution and use in source and binary forms, with or without modification, 
 * are permitted provided that the following conditions are met:
 * 
 * 1. Redistributions of source code must retain the above copyright notice, 
 *    this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright notice, 
 *    this list of conditions and the following disclaimer in the documentation 
 *    and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR 
 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 
 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 **/

#ifndef MCL_BITSTREAM_DECODER_HPP
#define MCL_BITSTREAM_DECODER_HPP

#include "mcl_bitstream_buffer.hpp"

namespace mcl
{

/**
The BitstreamDecoder will apply additional decoding functionalities to a bitstream buffer.
This includes reading in bit segments of unknown length between 0 and 32 bits in size 
using various coded methods such as exponential golomb coding.
*/
class BitstreamDecoder : public BitstreamBuffer
{
public:
	BitstreamDecoder(std::istream &a_istream) : BitstreamBuffer(a_istream){};
	virtual ~BitstreamDecoder();

	// Read unsigned exponential golomb encoded bits
	unsigned int read_bits_ue();
	// Read signed exponential golomb encoded bits
	signed int read_bits_se();

private:
	typedef BitstreamBuffer super;
};

};

#endif